home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1994 April / Inside Multimedia CD-ROM (April 1994).iso / prg / gs / gssource.exe / GSCIE.H < prev    next >
Encoding:
C/C++ Source or Header  |  1992-09-03  |  5.6 KB  |  168 lines
  1. /* Copyright (C) 1992 Aladdin Enterprises.  All rights reserved.
  2.    Distributed by Free Software Foundation, Inc.
  3.  
  4. This file is part of Ghostscript.
  5.  
  6. Ghostscript is distributed in the hope that it will be useful, but
  7. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  8. to anyone for the consequences of using it or for whether it serves any
  9. particular purpose or works at all, unless he says so in writing.  Refer
  10. to the Ghostscript General Public License for full details.
  11.  
  12. Everyone is granted permission to copy, modify and redistribute
  13. Ghostscript, but only under the conditions described in the Ghostscript
  14. General Public License.  A copy of this license is supposed to have been
  15. given to you along with Ghostscript so you can know your rights and
  16. responsibilities.  It should be in a file named COPYING.  Among other
  17. things, the copyright notice and this notice must be preserved on all
  18. copies.  */
  19.  
  20. /* gscie.h */
  21. /* Interface to Ghostscript CIE color algorithms */
  22. /* (requires gscspace.h)
  23.  
  24. /* ------ Common definitions ------ */
  25.  
  26. /* A 3-element vector. */
  27. typedef struct gs_vector3_s {
  28.     float u, v, w;
  29. } gs_vector3;
  30.  
  31. /* A 3x3 matrix, stored in column order. */
  32. typedef struct gs_matrix3_s {
  33.     gs_vector3 cu, cv, cw;
  34. } gs_matrix3;
  35.  
  36. /* A 3-element vector of ranges. */
  37. typedef struct gs_range_s {
  38.     float rmin, rmax;
  39. } gs_range;
  40. typedef struct gs_range3_s {
  41.     gs_range u, v, w;
  42. } gs_range3;
  43.  
  44. /* A 3-element procedure vector. */
  45. typedef float (*gs_float_proc)(P1(floatp));
  46. typedef struct gs_float_proc3_s {
  47.     gs_float_proc u, v, w;
  48. } gs_float_proc3;
  49.  
  50. /* CIE white and black points. */
  51. typedef struct gs_cie_wb_s {
  52.     gs_vector3 WhitePoint;
  53.     gs_vector3 BlackPoint;
  54. } gs_cie_wb;
  55.  
  56. /* ------ Color space dictionaries ------ */
  57.  
  58. /* Elements common to ABC and A dictionaries. */
  59. typedef struct gs_cie_common_s {
  60.     gs_range3 RangeLMN;
  61.     gs_float_proc3 DecodeLMN;
  62.     gs_matrix3 MatrixLMN;
  63.     gs_cie_wb points;
  64. } gs_cie_common;
  65.  
  66. /* A CIEBasedABC dictionary. */
  67. struct gs_cie_abc_s {
  68.     gs_range3 RangeABC;
  69.     gs_float_proc3 DecodeABC;
  70.     gs_matrix3 MatrixABC;
  71.     gs_cie_common common;
  72. };
  73.  
  74. /* A CIEBasedA dictionary. */
  75. struct gs_cie_a_s {
  76.     gs_range RangeA;
  77.     gs_float_proc DecodeA;
  78.     gs_vector3 MatrixA;
  79.     gs_cie_common common;
  80. };
  81.  
  82. /* Default values for components */
  83. extern const gs_range3 Range3_default;
  84. extern const gs_float_proc3 Decode3_default;
  85. extern const gs_matrix3 Matrix3_default;
  86. extern const gs_range RangeA_default;
  87. extern const gs_float_proc DecodeA_default;
  88. extern const gs_vector3 MatrixA_default;
  89. extern const gs_vector3 BlackPoint_default;
  90.  
  91. /* ------ Rendering dictionaries ------ */
  92.  
  93. typedef struct gs_cie_wbsd_s {
  94.     struct { gs_vector3 xyz, pqr; } ws, bs, wd, bd;
  95. } gs_cie_wbsd;
  96. typedef float (*gs_cie_transform_proc)(P2(gs_cie_wbsd *, floatp));
  97. typedef struct gs_cie_render_table_s {
  98.     int NA, NB, NC;            /* >1 */
  99.     byte **table;            /* [NA][m * NB * NC] */
  100.                     /* 0 means no table */
  101.     int m;                /* 3 or 4 */
  102.     gs_float_proc T[4];        /* [m] */
  103. } gs_cie_render_table;
  104. /* The main dictionary */
  105. typedef struct gs_cie_render_s {
  106.     gs_matrix3 MatrixLMN;
  107.     gs_float_proc3 EncodeLMN;
  108.     gs_range3 RangeLMN;
  109.     gs_matrix3 MatrixABC;
  110.     gs_float_proc3 EncodeABC;
  111.     gs_range3 RangeABC;
  112.     gs_cie_wb points;
  113.     gs_matrix3 MatrixPQR;
  114.     gs_range3 RangePQR;
  115.     struct { gs_cie_transform_proc u, v, w; } TransformPQR;
  116.     gs_cie_render_table RenderTable;
  117.         /* Following are computed when table is initialized. */
  118.     gs_matrix3 MatrixPQR_inverse;
  119.     gs_vector3 wdpqr, bdpqr;
  120. } gs_cie_render;
  121.  
  122. /* ------ Procedures ------ */
  123.  
  124. /*
  125.  * The decoding and rendering algorithms involve user-defined procedures.
  126.  * Since the interpreter handles these specially, the algorithms *return*
  127.  * to the caller between steps, rather than using a call-back.
  128.  * The scenario for decoding:
  129.  *    gs_cie_abc_decode1(abc, tabc)
  130.  *    ... DecodeABC(tabc) ...
  131.  *    gs_cie_abc_decode2(tabc, tlmn)
  132.  *    ... DecodeLMN(tlmn) ...
  133.  *    gs_cie_abc_decode3(tlmn, xyz)
  134.  * or:
  135.  *    gs_cie_a_decode1(a, ta)
  136.  *    ... DecodeA(ta) ...
  137.  *    gs_cie_a_decode2(ta, tlmn)
  138.  *    ... DecodeLMN(tlmn) ...
  139.  *    gs_cie_a_decode3(tlmn, xyz) [same as abc_decode3]
  140.  * The scenario for rendering:
  141.  *    gs_cie_render_colors1(xyz, wbsd, tpqr)
  142.  *    ... TransformPQR(wbsd, tpqr) ...
  143.  *    gs_cie_render_colors2(tpqr, tlmn)
  144.  *    ... EncodeLMN(tlmn) ...
  145.  *    gs_cie_render_colors3(tlmn, tabc)
  146.  *    ... EncodeABC(tabc) ...
  147.  *    gs_cie_render_colors4(tabc, colors)
  148.  */
  149.  
  150. /* Decode ABC values to XYZ. */
  151. extern int gs_cie_abc_decode1(P3(const gs_vector3 *pabc, gs_vector3 *ptabc, const gs_cie_abc *pcie));
  152. extern int gs_cie_abc_decode2(P3(const gs_vector3 *ptabc, gs_vector3 *ptlmn, const gs_cie_abc *pcie));
  153. extern int gs_cie_abc_decode3(P3(const gs_vector3 *ptlmn, gs_vector3 *pxyz, const gs_cie_abc *pcie));
  154.  
  155. /* Decode A value to XYZ. */
  156. extern int gs_cie_a_decode1(P3(floatp va, float *pta, const gs_cie_a *pcie));
  157. extern int gs_cie_a_decode2(P3(floatp ta, gs_vector3 *ptlmn, const gs_cie_a *pcie));
  158. #define gs_cie_a_decode3(ptlmn, pxyz, pcie) gs_cie_abc_decode3(ptlmn, pxyz, pcie)
  159.  
  160. /* Compute the cached values in a CIE rendering table. */
  161. extern int gs_cie_render_init(P1(gs_cie_render *pcie));
  162.  
  163. /* Render CIE colors */
  164. extern int gs_cie_render_colors1(P5(const gs_vector3 *pxyz, gs_cie_wbsd *pwbsd, gs_vector3 *ppqr, gs_cie_wb *points, const gs_cie_render *pcie));
  165. extern int gs_cir_render_colors2(P3(const gs_vector3 *ptpqr, gs_vector3 *ptlmn, const gs_cie_render *pcie));
  166. extern int gs_cir_render_colors3(P3(const gs_vector3 *ptlmn, gs_vector3 *ptabc, const gs_cie_render *pcie));
  167. extern int gs_cie_render_colors4(P3(const gs_vector3 *ptabc, float *colors, const gs_cie_render *pcie));
  168.